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We describe a new interactive database (GRDB) of geometric objects in the general area of dif- 
ferential geometry. Database objects include, but are not restricted to, exact solutions of Einstein's 
field equations. GRDB is designed for researchers (and teachers) in applied mathematics, physics 
and related fields. The flexible search environment allows the database to be useful over a wide 
spectrum of interests, for example, from practical considerations of neutron star models in astro- 
physics to abstract space-time classification schemes. The database is built using a modular and 
object-oriented design and uses several Java technologies (e.g. Applets, Servlets, JDBC). These 
are platform-independent and well adapted for applications developed to run over the World Wide 
Web. GRDB is accompanied by a virtual calculator (GRTensorJ), a graphical user interface to the 
computer algebra system GRTensorll used to perform on line coordinate, tetrad or basis calcula- 
tions. The highly interactive nature of GRDB allows for systematic internal self-checking and a 
minimization of the required internal records. This new database is now on line at http://grdb.org. 
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I. INTRODUCTION 



The study of exact solutions of Einstein's Field Equations is an important part of the theory of General Relativity 
jjj This importance derives not only from more formal mathematical aspects associated with the theory ( e.g. 
the classification of space-times) but also from the growing importance of the application of general relativity to 
astrophysical phenomena. For example, exact solutions can offer physical insights that numerical solutions can not. 
There are of course a very large number of exact solutions offered in the literature. However, these include numerous 
re-discoveries, confusions and errors. In a recent study of static spherically symmetric perfect fluid solutions, for 
_H ■ example, only 9 of 127 candidate solutions were found to be of physical interest ||. 

— I ' It is not surprising that some of the earliest applications of computer algebra can be found in General Relativity 
JfJ ||. Indeed, no effective study of exact solutions in the large can be carried on without it. With the recent rapid 
development of the World Wide Web (WWW) as an means of information transfer, it has become an effective medium 
for cataloguing exact solutions. The first such use of the WWW is due to J. Skea ||. Skea's database is primarily a 
classification database 0. It is static in the sense that the information that can be retrieved is resident in the records. 
5^ | In this paper we report on a non-static WWW based database, one for which the information that can be retrieved is 
bJ[). not restricted to information resident in the records. This development has become feasible using more recent WWW 
technologies. This new database is now on line at http://grdb.org (henceforth GRDB) using several Java technologies 
and following a fully modular object-oriented design. The dynamic nature of the database is accomplished via the 



inclusion of GRTensorJ 
system GRTensorll j§ i 



This is an interactive programmable graphical user interface to the computer algebra 
lich in turn runs under Maple JTo| | . 
GRDB is designed to be a database of geometric objects in the general area of differential geometry with no a 
priori restriction on the number of dimensions. It contains exact solutions of Einstein's field equations without being 
restricted to them. By design the database is highly interactive. The records (manifolds) are generally stored only 
in terms of a metric or a set of basis vectors along with constraints and referencing data. Other elements can be 
calculated and displayed as required either interactively or from an extensive menu. 

The database is designed for researchers (and teachers) in applied mathematics, physics and related fields and it is 
hoped that the database will find use over a wide spectrum of interests. 



II. DESCRIPTION AND USAGE 



GRDB offers many choices of operation. These operations are typically carried in the following order: 

• i) Search the database by fields of particular interest. A search by keywords or by an equation number e.g. 
as listed in the "Exact Solutions Book" jl| is implemented. Other searches can be easily added as the project 
evolves, e.g. a search by the equation number as listed in any standard reference. The keyword choice searches 
the information field and the name of the metric field of each entry in the database. A common use is a search 
based on an author's surname (e.g. Kruskal). The key word search must be at least 3 characters. Reference 
searches follow a simple referencing protocol. The search result is displayed in a list as shown on the bottom 
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of Figure y The record short name is displayed as a hyper-link. The record naming convention is explained in 
Appendix A. 

• ii) Select a record or records of interest from the search result list by clicking on its hyper-link. This will display 
a detailed description of the space-time starting with a suggestive line element representation of the record that 
is produced dynamically (not stored) . Record details are then displayed as in Figure ^| with a structure adapted 
to the type of the record examined (i.e. a metric, a tetrad or a basis type entry). 

• iii) Mark the viewed record(s) to be loaded into the on line calculator GRTcnsorJ. This calculator is described 
further bellow. 

• iv) Click on the Start Calculator button from the database home page in order to launch GRTcnsorJ and to do 
on line calculations for the loaded records. 

• v) Click on "Load/Select" from the menu inside the calculator (Figure ||) and then click on "Load Marked 
Manifold(s) from Database". The tagged manifolds will appear as choices under Load/Select. Click on the 
manifold you wish to use for calculations. This manifold is now loaded into the calculator and the user can 
now perform calculations. An extensive list of objects has already been implemented. This is summarized in 
Appendix B. Customized calculations are described below. 

• vi) Select the calculations commands through menu and sub-menu selections in the calculator as shown in Figure 
^. The first step is to select a space-time in coordinates, tetrads or basis. This choice automatically displays the 
components of the metric tensor, the tetrads, or the basis components. Then, the user can select the object(s) to 
be calculated from the corresponding menus. After the result of the calculation is displayed the user can apply 
to it any simplification procedure supported by the engine as listed under "Simplifications" in the menu bar. 
A help system is built into the menu system. Further, the user can define new objects through the definition 
facilities within GRTensorll. These are entered through a sub-interface and saved for the user's work session. 
There are also other support and option selection functions. It is especially important to note that if a manifold 
is represented with constraints (e.g Kruskal - Szekeres) then the constraints (under "Simplifications") must be 
applied on the calculations, otherwise the user is not working with the selected manifold. A number of useful 
features are easily added to GRTensorJ. For example, automatic Latex has been implemented |Tl|| . 

• vii) New objects are defined in a sub-menu using the syntax of the GRTensorll grdef facility |1 . For example, the 
Bel-Robinson tensor (though pre-defined) would be entered as v T{(cdef)} := C{acdb}*C{aefb}+Cstar{acdb}* 
Cstar£aefb}\ In addition, there are objects that require an input from the user, e.g. the kinematical quantities 
associated with a field u a . In order to create an object, select a manifold, then select under the menu item 
"Custom" the option "Create a new single definition object" . Follow the syntax explained under "Explanation" 
and the example shown on the object input interface, e.g. v u a :— [u 1 , u 2 , u 3 , u A ] v where u 1 etc. are the 
components. Once the object is created, it is saved during the user's work session and related calculations can 
be performed, e.g. the acceleration, shear and rotation for u a . For a full description of the syntax the user may 
consult GRTensorll || documentation on the command "grdef" or browse the on line help system from the 
GRTensorll WWW site @. 

• viii) Input in the database. There are two forms of input into the database, a Public Input and a Private 
Input. It is our intention that all public input be refereed. Private input is password protected and reserved 
for maintenance and internal operations. The List-All option is currently for private usage. The public input 
includes three types of interfaces; a line element, a covariant or contravariant Newman-Penrose tetrad or a 
non-holonomic basis. Figure gives an example of a line element input interface. 



III. INTERNAL DESIGN 
A. GRDB components 

GRDB is built using fully modular Client/Server and object-oriented designs. It uses Java Servlet technology p2| , 
a platform-independent mechanism for programming applications over the WWW. Java is a pure object-oriented 
language, allowing multi-thread processes, specially adapted to network applications. Java Servlets are secure and 
portable applications that handle requests from a Web server that are originating from a client Web browser. The 
servlet runs on the server side and does not depend on the browser compatibility. Java Servlets also solve many 
access issue problems, as they can be used to develop fully distributed applications over the Web where the database 
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can be on separate machines. GRDB also uses a JDBC (Java DataBase Connectivity) module a portable 

and flexible application that acts as an independent connector to the database, increasing the modularity of the 
architecture. PostgreSQL |Q was chosen and configured as the DataBase Management System (DBMS ), a system 
that is also object-oriented and that brings to GRDB all the power and performance of the Structured Query Language 
(SQL) commands. This language makes any kind of search or data manipulation very easy to implement. The SQL 
instructions are formulated within the Java Servlet code. The web-pages used in order to manipulate the Data are 
dynamic pages created while the programs are running. Only the help pages were left static. This HTML is also 
embedded in the Servlet code. The records (manifolds) are for the most part stored only in terms of a metric or set 
of basis vectors along with constraints and referencing data. This information is processed interactively through the 
Servlets and GRTensorJ which in turn runs on Maple. The program TTH |n| is used to translate TEX into HTML 
in order to produce mathematical html text. 

B. The Calculator GRTensorJ 

GRTensorJ is also written in Java and has been designed using a full object-oriented approach. In addition, all 
communication between the user and the server is object-based. GRTensorJ has a multi-layer architecture that allows 
the generic functionality described above. This architecture is outlined below: 

• GUI (Graphical User Interface) 

• User Functional Interface 

• User ICM (Interchange Module) Handler 

• Interchange Modules 

• Server ICM Handler 

• Server Functional Interface 

• Algebraic Engine - Server Structure 

A Java Applet (a programmed application that runs on the client side) opens GRTensorJ by clicking on the applet 
button on GRDB home page. It appears as in Figure Behind the scenes, a computer algebra session in GRTensorll 
is started automatically. GRTensorJ uses Maple as the algebraic engine. GRTensorJ is designed with an open 
architecture and is compatible with any other algebraic engine that can output an ASCII stream. This architecture 
also allows it to be expanded and programmed by the user. The commands are accessed through menu and sub- 
menu selections. When a session begins, GRTensorJ reads a directory on the server named TextSheets (not to be 
confused with "worksheets") and builds the menu and sub-menus for the interface from the underlying structure. All 
sub-directories to TextSheets will appear as primary menu bar items. The names of ASCII files contained within 
these sub-directories will be displayed as menu selections. These files contain a sequence of commands written in the 
syntax of the computer algebra engine being used. By selecting a menu item the user sends these commands to the 
engine. Items to be displayed in the interface window are distinguished simply by an asterisk in the file. In other 
words, creating new menu items and calculation commands is as simple as creating and editing very simple ASCII 
files. Yet, the file, and resultant menu item, can be the equivalent of an entire worksheet with only the result chosen 
for display. Of course, users need program nothing at all. The underlying simplicity of GRTensorJ is mentioned here 
simply to demonstrate its flexibility. 

IV. FURTHER DEVELOPMENTS 

When first released (July 2001), the database contained only about 300 entries. This is under continuous develop- 
ment and, for example, it is planed to have the entire content of JjJ and included in the database. An extension 
of the database to incorporate algorithmic classification is in progress |l(| as is the construction of specialized record 
data associated with, for example, static spherically symmetric perfect fluid solutions ||. 
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APPENDIX A: RECORD NAMING CONVENTION 

The record naming convention is not of significant interest to the user as it is merely a placeholder for links. The 
convention does, however, convey some information that can be quickly digested by the user. The naming convention 
is as follows: "abc" 

• 1: No numbers 

• 2: All lower case 

• 3: a=name (e.g. bondi) 

• 4: b=m (metric), or npd (covariant tetrad), or npu (contravariant tetrad), or b (basis) 

• 5: c=a,...,z (version) 

• 6: Default signature for metrics +2 for NP tetrads -2. 
examples: 

kerrma means the Kerr spacetime in metric form version a 

kerrmb means the Kerr spacetime in metric form version b 

kerrnpda means the Kerr spacetime in NP tetrad covariant form version a 

kerrnpua means the Kerr spacetime in NP tetrad contravariant form version a. 



APPENDIX B: INITIAL SET OF PREPROGRAMMED OBJECTS AVAILABLE FOR CALCULATION 
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GRTensorJ menu item GRTensorJ sub- menu command Object (s) 



Metric 



Christoffel Symbols 

Geodesic 
Riemann 



Weyl 
Ricci 

Trace-free Ricci 

Einstein 

Invariants 



Differential Invariants 



Bel- Robinson 

Weyl-Schouten 

Bach 

Input field calculations 



Metric 

Signature 

Line Element 

Determinant of Metric 

Inverse Metric 

Partial Derivative of Metric 

Chr(dn,dn,dn) 

Chr(dn,dn,up) 

R(dn,dn,dn,dn) 

R(up,dn,dn,dn) 

R(up,up,dn,dn) 

R(up,up,up,up) 

Kretschmann 

C(dn,dn,dn,dn) ... 

Dual CStar(dn,dn,dn,dn) ... 

R(dn,dn) ... 

S(dn,dn) ... 

G(dn,dn) ... 

Invariants- Ricci 

Invariants- Weyl 



Invariants-Mixed 



diRicci 
diRiem 
diS 

diWeyl 

T(dn,dn,dn,dn) ... 
Weyl-Schouten ... 
B(dn,dn) ... 
Field u 
KillingCoords 
KillingTest 
Vector Kinematics 

Electric Weyl E(dn,dn) ... 
Magnetic Weyl H(dn,dn) 



dab 

Sig 
ds 2 
det(g) 

g ab 
gab,c 

1 ab 

Writes out the geodesic equations 

Rabcd 

-K bed 
r>a6 
ti cd 
j^abed 

r> Tjabcd 
riabedti 

Cabcd 

* = I 
abed — 2 

Rab 

Sab = Rab 
Gab = Rab 



C* _ i r^ e f 
abed = 2 €abe f Lj cd 

1 acb 

Jf9abR 
2dabR 



K-rab = n a b ~ j^ab^ 

r» — rya pi — 1 oa ab rjr, — — 1 na ab t 
It = it a, ftl = 4<J bJ a, tti = — O bJ c>- 

r>o — 1 oa cyb c*c od 
= 16 b c d 
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W1R = -gCabcdC 

W2R=^C ab cd C cd 



abed 



"" Cd , WII=\C* abcdC a 
ef s~i ab 

W2I=^C t ab Cd C C a ef C ef ab 
MIR = ±S ab S Cd C ab cd, Mil = ±S ab S Cd C* abed 

MIR = ±S cd S ef (C acdb C^ b ~ C* acdb cr fb ) 

1 nbr. n / s~i* s~iaefd\ 

^aefb\ 
f,^* ) 



Mil = \S bc sJ{C:Z d C a£fd ) 
M3= ±S cd S ef (CacdbC aefb 



c, 



db 



2MO— lf .^ ^ej\^acdb^ T ^aedb^* 

MAl = ^S C3 S e} S C d (Cac db Cbefg + C* c dl 'C be f g ) 
M5R = ■^S Cd S e - f C a9hb (CacdbC ge fh + C* cdb C* e f h ) 
M51 = joS Cd S ef C* a9hb (CacdbCgefh + C* cdb C* efh ) 

M6R = j 2 -Sa e S e c S b f S f d C ab cd 
M6I = ±Sa e S e c S b f Sf d C nab cd 

r» -nab— 
ftab;cft 

Rabcd;eR' 

S a b;cS 



>abcd;e 



•ab:c 



~iabcd;e 



C a bcd;eC° 

Ti — /~i /-va b I s~i* r-i* a b 

cdef = ^aedb^ ef fl> aedb^ ef 

WS abc = Rab.e ~ Rac;b ~ (QabR" e;c ~ QacR S /;&)/4 



WSabc = Rab;c 

B— (~i :bd 
ac — \sabcd 

u a 

Adapted coordinate check 
Test for conformal/homothetic/Killing vector 
ii a = u b u a , b 

\h a b e, U,' 

E ac = Cabc d U b U a 
H ac = C* abcdU U d 



1 jybdf-i 
2 JX ^abed 



U b -h, Oa b 



Jab = U[ a -b] + U[ a U b ] 



U(a~' b ) +U (a U b ) - 



TABLE I: Initial set of preprogrammed objects available for coordinate calculations. Note: means that all index combi- 
nations are immediately available as with Riemann. 
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GRTensorJ menu item GRTensorJ sub-menu command 



Object (s) 



NPSpin 



NPSpin: NPkappa, NPsigma, NPlambda, 
NPnu, NPrho, NPmu, NPtau, NPpi, 
NPepsilon, NPgamma, NPalpha, NPbeta 



spin coefficients, 
K,a,...,@ 



NPSpinbar 



NPSpinbar: NPkappabar, NPsigmabar, 
NPlambdabar, NPnubar, NPrhobar, 
NPmubar, NPtaubar, NPpibar, NPepsilonbar, R, a, . . . j3 
NPgammabar, NPalphabar, NPbetabar 



spin coefficients 
(complex conjugates) 



Ricci Scalars 



Ricci Scalars: PhiOO, PhiOl, Phi02, 
PhilO, Phill, Phil2, Phi20, Phi21, 
Phi22, Lambda 



Ricci scalars, 



Weyl Scalars 



Weyl Scalars: PsiO, Psil, Psi2, Psi3, Psi4 



Weyl scalars, $o, ■ ■ ■ , ^4 



Petrov 

Petrov Report 



Petrov type 

A report on how the 

Petrov type was determined 



TABLE II: Initial set of preprogrammed objects available for tetrad calculations. All the objects in TABLE I are integrated 
with tetrad input and can be run directly from a tetrad. 

GRTensorJ menu item GRTensorJ sub- menu command Object (s) 

Rotation Coefficients lambda(bdn,bdn,bdn) \a)(b)(c) '■= e(b)[i,j]e(a) d e( c ) e 

rot(bdn,bdn,bdn) rotation coefficients, 

7(a)(6)(c) := \ (A(a)(6)(c) + \c)(a)(b) ~ A(6)( c )( a) ) 

str(bdn,bdn,bdn) structure constants, 

C(a)(6)(c) := 7(a)(c)(6) ~ 7(a)(6)(c) 



TABLE III: Initial set of preprogrammed objects available for basis calculations. All the objects in TABLE I are integrated 
with basis input and can be run directly from a basis. 
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Interactive Geometric Database 

QUCCnS Including Exact Solutioug of Einskin v Field Equations 

Version 1..G 
Lubii dcvcLoffCiLiiiJ: by 
!£. iutjp?in Tjliafc au-i K syU Lake 

Pubtk Tnfuiiwirton TTi-l]i CI • Ri-Smlc* PnljUr Input 

FnivaliJ DfctflV*** Lhi Ml Prfcftlf Input 

8 Search by Ke^on* £«£ KtMeM* f Scarcity KSHM8 pl5fl) 



Seiurh Results Frmin l>atithas* 





NaW&. Pesrrijrtimi 


i 




i'NuB form ofKmslod Ssckejc* cqtmvhUS b^EK v 


2 




! K^siail form Kmkai Siekcrcs co^nnorl t)Hi» n 


3 


ithv.tti 


.'Nail form cf XmsksJ ^ackercs cocEnc'' 


1. 




'I>jB(gMul form uf Eniska] Sickeirs tiirtnr" 



FIG. 1: GRDB Home Page (at the WWW address http:/ /grdb.orj ). The operations on the database available at the time 
this paper was written are displayed, followed by the search form and the Calculator Applet button. Part of the search result 
by the key word "Kruskal" is displayed. 
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Me?rcc NjanE : 
Mace Infcnna^cjj ■ 
Mrfrtie Ecfcraiici . 

M«kc DsiuKKuon : 
C*wfi5niarte 2f1_ 

Meiric Si^stuis ■ 
Mrfric C-sirplcK . 

: C«npMi«it g^l4_ : 
is C-jistSMxM . 




£C&WH]f 

"■Nvll form of KnjEknll ^ Ecfceres metric'' 

■J 

u 




Lbs E«;*iit (HTML). -16 (fca-Q m-rfc,^) 4U4 v ^^,v)]+fK^^y d 



FIG. 2: Details Of The Manifold's Record. The corresponding line element is displayed in a suitable "Tex to Html" mathe- 
matical format. The fields contain the components of the metric tensor, the referencing data and an information line on the 
manifold. The button at the top serves to mark the record to be loaded in the Calculator. 
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S^iwai LMdfSeJKt Cumam Het> Cctora C«**i^<.aiaJbtfG« W> Tetrad akUWUns £&t&taons 
SnpYfedions ft « date 

GRTersorJ: Version GRDB 




FIG. 3: GRTensorJ Graphical User Interface. Calculation of the differential invariant ("diRiem") R a bcd:eR abcd ' e for the Kerr 
metric is shown. At the time of writing, this calculation executes in under one second on a contemporary PC. The calculation 
commands are selected from menus and sub-menus. The help is embedded in the menu and appears under "Explanation". 
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grdb PntUr Lfcie Element Lijnrt Page 



Y-OW JtUlflC - 

I 




FIG. 4: GRDB Public Line Element Input Page. The fields are entered by the user following the syntax provided in the 
examples shown at the top of each box. 



